home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / UTILFILE / NJFIND.LZH / NJFIND.DOC < prev    next >
Text File  |  1991-12-21  |  17KB  |  366 lines
  1.  
  2.  
  3.                                                   _______
  4.                                              ____|__     |               (tm)
  5. Nifty James' File Find Utility            --|       |    |-------------------
  6. Version 2.15 of 9 December 1991             |   ____|__  |  Association of
  7. (C) Copyright 1989, 1990 by Mike Blaszczak  |  |       |_|  Shareware
  8. All Rights Reserved                         |__|   o   |    Professionals
  9.                                           -----|   |   |---------------------
  10.                                                |___|___|    MEMBER
  11.                                       
  12.      PURPOSE                         
  13.      -------
  14.      
  15.      NJFIND is a file-finder utility.  Users with large (or crowded) hard
  16.      disk drives will welcome NJFIND as a tool to find filenames based on
  17.      a wildcard specification.  NJFIND works across all directories of a
  18. |    logical drive, and will even open DWC, ZIP, LZH, ZOO, PAK, ARJ,
  19. |    and ARC files to check them for matching filenames.  NJFIND can also
  20. |    scan across different disk drives, if you so desire.
  21.      
  22.      
  23.      
  24.      FEATURES
  25.      --------
  26.      
  27.      NJFIND works with standard DOS file names.  The program will also
  28.      "open" several types of archive files.  These include the popular ZIP
  29.      and ARC formats, as well as the public domain ZOO and LZH formats.
  30.      NJFIND also can read PAK files.
  31.      
  32.      NJFIND runs quickly.  I have over two-hundred files stored with LHARC
  33.      on my hard drive, and I have over fifteen-hundred files on my hard
  34.      drive.  NJFIND will scan the entire drive in less than thirty
  35.      seconds.
  36.      
  37.      NJFIND requires less than twenty kilobytes of disk space.  Because
  38.      it uses standard DOS file input and output. Because it uses no
  39.      special trickery, the program should be compatible with protected
  40.      environments such as DesqView and Microsoft Windows.
  41.      
  42.      NJFIND has been tested successfully on an IBM Token Ring network using
  43.      Novell SFT Netware.
  44.  
  45. |    NJFIND allows the user to keep a set of their favorite options in the
  46. |    system environment so that commonly-used options need not be retyped
  47. |    each time the program is invoked.
  48.  
  49.      
  50.      
  51.      
  52.      USAGE
  53.      -----
  54.      
  55.      You may use NJFIND to scan all of your hard drive and all archive
  56.      files by using the command followed by a filename.  For example:
  57.      
  58.         NJFIND GOOFY.TXT
  59.      
  60.      searches the current drive for the file GOOFY.TXT.  Should you wish,
  61.      you can have NJFIND run a drive other than the default drive.  To do
  62.      this, simply include a drive specification.  To look for GOOFY.TXT on
  63.      drive H, one would use the command
  64.      
  65.         NJFIND H:GOOFY.TXT
  66.      
  67.      If you are looking for a file with a name you can't specifically
  68.      remember, you may use wildcards in the filename given to NJFIND to
  69.      search the drives and files on your system.  If you knew that your
  70.      text file began with a G, for example, you might use
  71.      
  72.         NJFIND H:G*.TXT
  73.      
  74.      If you knew that you had called the file MODEL but couldn't remember
  75.      the extension it had,
  76.      
  77.         NJFIND MODEL.*
  78.      
  79.      would do the job.
  80.  
  81.      Note that NJFIND searches *all* archive files it notices, even
  82.      if they don't match the wildcard specification that you supply.
  83.      
  84.      If you have many of the supported archive files on your diskette, you
  85.      may be noticing that NJFIND runs a little slower.  If you are looking
  86.      only for "normal" DOS files, you can use the /N option to cause
  87.      NJFIND to search only DOS directories.  That would make the above
  88.      command look like this:
  89.      
  90.         NJFIND /N MODEL.*
  91.      
  92.      Since you might know that the file is not stored in an archive, you
  93.      can expidite the search by using /N.  Normally, NJFIND searches ZIP,
  94.      ARC, ZOO, PAK, and LZH files when it finds them.  You can switch off
  95.      these file choices individually, as well.  For example, to search for
  96.      NJFIND.C without looking in LZH or ZOO files, you may use
  97.      
  98.         NJFIND /O /L NJFIND.C
  99.      
  100.      The options and their related archive files are shown here:
  101.      
  102.         /A              Don't search throghh ARC files
  103.         /L              Don't search through LZH files
  104.         /O              Don't search through ZOO files
  105.         /P              Don't search through PAK files
  106.         /Z              Don't search through ZIP files
  107.     /W        Don't search through DWC files
  108. |    /J        Don't search through ARJ files
  109.      
  110. |    You might notice that /N is simply a more convenient form for
  111. |    using /A /L /O /P /Z /W /J all out.
  112.      
  113.      If you'd like, you can have NJFIND print out messages as it traverses
  114.      your hard drive and checks files.  To do this, use the /D option to
  115.      display the filenames NJFIND searches through, as well as the ones it
  116.      finds.
  117.      
  118.      NJFIND is capable of displaying file directory information, as well. 
  119.      If you would like to see the last modification date and time as well
  120.      as the attributes and size of found files, use the /V option.  /V
  121.      stands for "verbose mode".
  122.      
  123.      It is often handy to have just a total of file information.  For
  124.      example, you might want to see how many .GIF files are on your hard
  125.      disk, and how much room they're taking up.  You can use the /T option
  126.      to have NJFIND print out only the totals information, instead of also
  127.      displaying the name and location of all the found files.
  128.      
  129.      Our example with .GIF files might look like this:
  130.      
  131.         NJFIND /T *.GIF
  132.  
  133.      When NJFIND prints out the number of files found, the number
  134.      indicates the number of files that were not in archives.  If any
  135.      files were "inside" of archives, NJFIND will note that number of
  136.      files with "archived files".
  137.  
  138.      If you ran NJFIND and it printed, for example,
  139.  
  140.         6 files found.
  141.         18 archive files found.
  142.  
  143.      it would mean that NJFIND came across 24 files that matched your
  144.      specification.  Six of these files were regular DOS files, but
  145.      eighteen of the files were actually inside archive files.
  146.  
  147.      NJFIND will search through archive files if it finds them and
  148.      recognizes them by their extension.  Notice that, if you have an
  149.      archive file and it doesn't have the normal file extension, the
  150.      file won't be checked by NJFIND.
  151.      
  152.      If you find yourself confused about NJFIND's options, you can run
  153.      NJFIND without any options and it will show you a display of the
  154.      usage information.  NJFIND will also do this if you try to use an
  155.      option it doesn't recognize.
  156.  
  157.      If you're running NJFIND and realize something's wrong (or you
  158.      have a huge disk and ge tired of waiting), you can use <CTRL+C> or
  159.      <CTRL+BREAK> to stop the program.  NJFIND will tell you what
  160.      it's found so far, and then leave you at the DOS prompt.
  161.  
  162.      Edward Mendelson wrote to me on CompuServe and suggested that I
  163.      provide an option to allow the program to search through all the
  164.      drives attached to a system.  This was a pretty good idea and
  165.      I have implemented it in Release 1.10.  If you use the /R
  166.      option, NJFIND will go through all of the drives looking for
  167.      your file.  If the filespec you provide contains a drive
  168.      specification, it will be ignored.  NJFIND searches your drives
  169.      in alphabetical order, starting with your first hard disk drive
  170.      or RAM disk, such as NJRAMD.  NJFIND does not search floppy
  171.      drives in this mode.
  172.  
  173.      Both Edward and Heward Hane noticed that NJFIND occasionally
  174.      printed out that a archive file was found in the target file;
  175.      that is, the file found message was ocassionally reversed.  This
  176.      problem has been fixed in Release 1.10.
  177.  
  178.      Edward Mendelson noticed a problem matching spurious filenames
  179.      in this release.  The rub was that NJFIND would match files
  180.      shorter than the wildcarded filespec, but only when the wildcard
  181.      didn't extend into the actual filename.  (Whew!)  Again, hats
  182.      off to Edward, who seemingly doesn't sleep when our world has
  183.      buggy software!
  184.  
  185. |    David Nanian sent me a note on BIX mentioning that NJFIND, when
  186. |    compiled with a different compiler than I used, generated code that
  187. |    caused a system crash.  As it turned out, some mutant memory
  188. |    allocation was going on in some of the code, and this got tidied up.
  189.       
  190.       
  191.      LEGAL JUNK
  192.      ----------
  193.      
  194.      ARC is a file format and a file compression program developed and
  195.      sold by System Enhancement Associates.  ZIP is a file format and file
  196.      compression program developed and provided by Phil Katz of PKWare. 
  197.      LZH is a public-domain file format manipulated by the program LHARC,
  198.      among others.  ZOO is another public-domain file format for the
  199.      compression and archival of data.
  200.      
  201.      NJFIND probably would not have been possible without the BRIEF
  202.      programming editor from Underware.  If you program in any language
  203.      under MS-DOS or OS/2, give BRIEF a look!  BRIEF is marketed by
  204.      Solution Systems, but written by Underware.
  205.      
  206.      
  207.      
  208.      SOURCE CODE
  209.      -----------
  210.      
  211.      The archive or disk which brought you NJFIND should also include the
  212.      sourcecode and make files for the program.  If you're not a
  213.      programmer, you probably won't be much interested in what makes
  214.      NJFIND go.  However, if you are a coder, you may enjoy perusing the
  215.      file NJFIND.C.
  216.      
  217.      NJFIND was written completely in Microsoft C Version 5.10.  You can
  218.      use the MAKE utility supplied in the Microsoft C package to build the
  219.      program.  NJFIND. makes the standard program and NJFINDD. makes the
  220.      debugging version.  This debugging version spews out extra information
  221.      about the progress that NJFIND is making, as well as some information
  222.      about the internals that NJFIND uses to compare files and traverse
  223.      the directory structure.
  224.      
  225.      I am certain that NJFIND will not compile in the QuickC interactive
  226.      environment, but it may compile with the QCL command-line compiler.
  227.      I know nothing of NJFIND's compatibility with Borland's Turbo C
  228.      product, but I also know for certain that NJFIND will not compile
  229.      as-is on the Lattice C Compiler, Version 6.01.   At least a few of
  230.      the runtime library call names must be changed.
  231.  
  232.      
  233.      COMPATIBILITY
  234.      -------------
  235.      
  236.      NJFIND has been tested with these products:
  237.      
  238. |       Phil Katz/PKWare                PKZIP   Version 1.10
  239.         Haruyasu Yoshizaki              LHARC   Version 1.13B
  240.         Phil Katz/PKWare                PKARC   Version 3.5
  241.         System Enhancement Associates   ARC     Version 6.00
  242.         NoGate Consulting               PAK     Version 2.10
  243.         Rahul Dhesi                     ZOO     Version 2.01
  244. |    Dwight W. Campbell              DWC     Version 5.01
  245.     Robert K Jung            ARJ    Version 2.00
  246.         
  247.      If you're using an older version of an archiver product, please
  248.      contact the author of that product about getting an upgrade.  I can
  249.      not obtain older versions, and thus can't guarantee (and frankly
  250.      don't see a need for) backward compatibility.
  251.      
  252.      If you have a newer version of one of these packages and notice that
  253.      NJFIND doesn't seem to be working correctly, please do send me a
  254.      note.  I will be very interested in fixing NJFIND promptly to handle
  255.      newer file compression programs.
  256.      
  257.      
  258.      
  259.      REFERENCES
  260.      ----------
  261.      
  262.      I used Phil Katz's APPNOTE file, which is distributed with the
  263.      PKZ101.EXE self-extracting Shareware version of his software.  This
  264.      file had great descriptions of the data structures used in ZIP files.
  265.      
  266.      For ARC, I hacked around in the file and discovered the relatively
  267.      simple file structure for myself.  Since NJFIND doesn't need much
  268.      information from the file, this was relatively easy.
  269.      
  270.      The LHARC files were dissected by examining the sourcecode for the
  271.      package, as found in the LHARCSRC.LZH file in a few places.  As with
  272.      the Phil Katz program, the availability of sourcecode and
  273.      documentation made developing the pertinent sections of NJFIND a
  274.      snap.
  275.      
  276.      Information for the PAK file format came from the "Technical Notes"
  277.      section of PAK.DOC, which I found as part of PAK210.EXE on a local
  278.      bulletin-board system.
  279.      
  280.      The ZOO file format was another one that I had to hack apart myself,
  281.      since Rahul Dhesi didn't see fit to put a description of the file
  282.      format in his Shareware distribution package.  (This seems odd to me.
  283.      He set things up with .MAN files and made documentation that
  284.      resembles traditional Unix man files, but he didn't include file
  285.      format manual pages ... most Unix systems (or at least SunOS) does
  286.      this.  Oh, well.)  Of the five, this was the format that was a bear to
  287.      figure out, but I eventually got it down.
  288.  
  289. |    Dwight Campbell was kind enough to send me a diskette with sourcecode
  290. |    to a "verbose lister" for his DWC format.  This let me write the
  291. |    supporting code for DWC archives in a very straightforward manner. 
  292. |    The code to process DWC files is basically lifted straight from his
  293. |    example.
  294.  
  295.      
  296.      
  297.      AVAILABILTY
  298.      -----------
  299.      
  300.      Should you be interested in any enhancements, changes, or a
  301.      customized version of NJFIND, please do not hesitate to drop me a
  302.      line.  I am occasionally avaialable for customized programming
  303.      projects on a by-contract basis.  Should you have the need for solid
  304.      software in the IBM-PC or Unix enviroments, please do feel free to
  305.      contact me.
  306.      
  307.      
  308.      
  309.      
  310.      REGISTRATION
  311.      ------------
  312.  
  313.      This program is produced by a member of the Association of
  314.      Shareware Professionals (ASP).  ASP wants to make sure that the
  315.      shareware principle works for you. If you are unable to resolve
  316.      a shareware-related problem with an ASP member by contacting the
  317.      member directly, ASP may be able to help. The ASP Ombudsman can
  318.      help you resolve a dispute or problem with an ASP member, but
  319.      does not provide technical support for members' products. Please
  320.      write to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006
  321.      or send a CompuServe message via EasyPlex to ASP Ombudsman
  322.      70007,3536.
  323.      
  324.      NJFIND is a work of Shareware.  If you use the program, please
  325.      register your copy.  This will expidite your receipt of future
  326.      versions and also net you a nice letter in return.
  327.      
  328.      While you may have purchased NJFIND through the mail, paying the
  329.      distribution house for the diskette DOES NOT register the program! 
  330.      The same is true with copies attained from online systems and user
  331.      group libraries.
  332.      
  333.      If you are interested in redistributing or republishing NJFIND,
  334.      please contact me at my address below.  You will find that getting
  335.      permission to do so is remarkably easy, if your intent is kosher.
  336.      
  337.      To register your copy, please send a registration fee of $10 to my
  338.      address below.  You will be added to my mailing list for this
  339.      program, receive a list of my other releases, and be eligible to
  340.      upgrade NJFIND for one dollar, should a new version become available.
  341.      
  342.      Thank you for your interest!
  343.      
  344.      
  345.      Mike Blaszczak
  346.      112 Verlinden Drive
  347.      Monroeville, Pennsylvania
  348.         15146-2041
  349.  
  350.      
  351.      You can also reach me at any of these electronic hangouts:
  352.  
  353.      BIX                      : blaszczak
  354.      EasyPlex on CompuServe   : 76360,157
  355.      GEnie Mail               : M.BLASZCZAK
  356.      PARTICIPATE on Unison    : NIFTY JAMES
  357.  
  358.      If I'm not online, I'm either travelling on my motorcycle
  359.      through the beautiful New England countryside or attending a
  360.      performance of live music somewhere.  (Please note that my
  361.      access to PARTICIPATE on CompuServe has been removed
  362.      indefinitely, as it appears that CompuServe refuses to support
  363.      The PARTICIPATE Conferencing system as a product.)
  364.  
  365.  
  366.